package com.youlai.boot.modules.game.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.youlai.boot.modules.game.model.entity.GameUserStatistics;
import com.youlai.boot.modules.game.model.vo.GameUserStatisticsVO;

import java.util.List;
import java.util.Map;

/**
 * 游戏用户统计服务接口
 *
 * @author 有来技术团队
 */
public interface GameUserStatisticsService extends IService<GameUserStatistics> {

    /**
     * 获取用户统计信息
     *
     * @param userId 用户ID
     * @return 用户统计信息
     */
    GameUserStatisticsVO getUserStatistics(Long userId);

    /**
     * 更新用户统计信息
     *
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean updateUserStatistics(Long userId);

    /**
     * 查询近30天每日游戏时长
     *
     * @param userId 用户ID
     * @return 每日游戏时长列表
     */
    List<Map<String, Object>> getDailyPlayTime(Long userId);

    /**
     * 查询用户游戏时段分布
     *
     * @param userId 用户ID
     * @return 时段分布列表
     */
    List<Map<String, Object>> getHourlyDistribution(Long userId);

    /**
     * 初始化用户统计信息
     *
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean initUserStatistics(Long userId);
} 